home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mlib14.zip / MADLIBS.DOC < prev    next >
Text File  |  1990-06-29  |  9KB  |  334 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                     MAD LIBS
  21.                                    for RBBS-PC
  22.  
  23.             Based on the party game by Roger Price and Leonard Stern
  24.  
  25.           Mad Libs copyright 1965, 1982 by Price/Stern/Sloan Publishers
  26.                              Los Angeles, California
  27.  
  28.           Mad Libs is a registered trademark of Price/Stern/Sloan, Inc.
  29.  
  30.        Program and documentation copyright 1989, 1990 by Michael Walsh
  31.                  Walsh MicroSystems, Philadelphia, Pennsylvania
  32.  
  33.               Released into the public domain for use with RBBS-PC
  34.                                  as a door game
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         Mad Libs Documentation                                Page 2
  68.  
  69.  
  70.         INTRODUCTION
  71.  
  72.         Mad Libs was originally intended as a party game.  It envolves a 
  73.         short story, and there are blanks that are filled in with parts 
  74.         of speech, words, numbers, colors, etc. and the resulting story 
  75.         is read back to the group.  Invariably, the stories tend to be 
  76.         quite funny, as the words that get filled in are rarely the ones 
  77.         intended in the first place.
  78.  
  79.         In this implementation, the user is asked for the words to fill 
  80.         into the story, but the user has no idea what the story is about, 
  81.         nor what the final result may be like.  Only when all of the 
  82.         missing words are asked for and given is the story printed out.
  83.  
  84.         Playing Mad Libs is really very easy, and the stranger and wilder 
  85.         the words given, the funnier the resulting story is.  Stories are 
  86.         chosen randomly by the game, and the user may play as many times 
  87.         as he or she likes.  The user's time is checked each time a story 
  88.         is completed, and if a user has been in Mad Libs for more than 
  89.         the alloted time (based on the DORINFO?.DEF file or 30 minutes, 
  90.         whichever is less) the user is returned to the BBS.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.         Mad Libs Documentation                                Page 3
  134.  
  135.  
  136.         INSTALLATION
  137.  
  138.         Installation is very easy and completely straightforward.
  139.  
  140.         1.   Create a subdirectory for the MAD LIBS program and files.
  141.         2.   Unpack the files to that subdirectory.
  142.         3.   Create the batch file to drive the program.
  143.         4.   Update your DOORS.DEF file to include MAD LIBS.
  144.         5.   Update your MENU5 files to include the MAD LIBS option.
  145.  
  146.         The batch file that drives the door is easy to make.  First, you 
  147.         want to change to the directory you created for MAD LIBS, and 
  148.         then invoke the MAD LIBS program with a complete path to your 
  149.         DORINFO?.DEF file.  If the directory you created was named 
  150.         \RBBS\MADLIBS, your main RBBS directory was called \RBBS, and you 
  151.         were running a single RBBS node, then the batch file would look 
  152.         like this:
  153.  
  154.         CD \RBBS\MADLIBS
  155.         MADLIBS \RBBS\DORINFO1.DEF
  156.         CD \RBBS
  157.         RBBS
  158.  
  159.         All of the necessary information for the program to run is 
  160.         included in the DORINFO?.DEF file.  For multiple nodes, check the 
  161.         RBBS documentation for hints on the DOORS.DEF file and using 
  162.         parameters in batch files.
  163.  
  164.  
  165.  
  166.  
  167.         RUNNING MAD LIBS
  168.  
  169.         In operation, MAD LIBS displays a status line on the 25th line
  170.         of the screen.  The format of the status line is:
  171.  
  172.         <USER NAME>  F10=CHAT    TIME ON: xx min  INPUT TIMER: x:xx
  173.  
  174.         The TIME ON number is the number of minutes the user has been
  175.         in MAD LIBS.
  176.  
  177.         The INPUT TIMER is displayed when MAD LIBS is waiting for input.
  178.         It is reset by any keypress either locally or by the remote user.
  179.         If the INPUT TIMER reaches 3 minutes, a SLEEP DISCONNECT occurs
  180.         sending the user back to the BBS.
  181.  
  182.         Pressing the F10 key will cause MAD LIBS to enter CHAT mode, in
  183.         the same way as RBBS.  To exit CHAT, press ESC.
  184.  
  185.         When running locally, the word LOCAL appears instead of F10=CHAT
  186.         in the status line.
  187.  
  188.         Mad Libs now saves stories created by the user to disk so that
  189.         the SysOp can review them.  The file is created in the current
  190.         directory, and is called USERLIBS.TXT.  This file is not shared
  191.         in the current version, so multi-node operation is probably not
  192.         a very good idea.  A future release will correct this problem.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.         Mad Libs Documentation                                Page 4
  200.  
  201.  
  202.         MAKING YOUR OWN STORIES
  203.  
  204.         There are 19 stories included in this release of MAD LIBS.  
  205.         Making your own is also quite easy, and you can look at the 
  206.         stories included to get an idea how this is done.  Stories are 
  207.         just flat ASCII text files with the key words (words to be asked 
  208.         for) taken out and replaced by a prompt within braces.  An 
  209.         example of this follows.  Given the sentence:
  210.  
  211.         The rain in Spain falls mainly in the plain.
  212.              ^              ^                   ^       To be replaced 
  213.            A Noun        A Verb              A Noun   
  214.  
  215.         The resulting replacements would look like this:
  216.  
  217.         The {A Noun} in Spain {A Verb} mainly in the {A Noun}.
  218.                ^                 ^                       ^     Prompts
  219.  
  220.         The characters appearing between the braces become the prompt for 
  221.         the word to be entered by the user.  Given the above example, the 
  222.         user would be prompted as follows:
  223.  
  224.         Please enter A Noun.
  225.         <user enters a noun>
  226.         Please enter A Verb.
  227.         <user enters a verb>
  228.         Please enter A Noun.
  229.  
  230.         and so on.  If you have two blanks (words) in a row that are the 
  231.         same part of speech, then you may want to make the prompts 
  232.         clearer by saying Another Noun, i.e.:
  233.  
  234.         The {A Noun} in Spain falls mainly in the {Another Noun}.
  235.  
  236.         Since the words are asked for in the order that they appear in 
  237.         the story, this would result in prompts that look like this:
  238.  
  239.         Please enter A Noun.
  240.         <user enters a noun>
  241.         Please enter Another Noun.
  242.  
  243.         and so on.  This is clearer than two identical prompts that might 
  244.         make the user feel that the game rejected his previous word for 
  245.         some reason.  Take a look at the examples provided to get a 
  246.         better idea of how this is done.
  247.          
  248.         IMPORTANT: The MAD LIBS program will perform word-wrap 
  249.         automatically, so don't worry about how long a line is!  Only 
  250.         press [ENTER] when you are finishing a paragraph, and then press 
  251.         [ENTER] twice.  I use WordStar to edit these files, since 
  252.         WordStar doesn't care how long a line is in non-document mode.  
  253.         Lines will be wrapped by MAD LIBS.  Any other program that does 
  254.         not force word-wrap should be fine, including EDLIN, the SideKick 
  255.         editor, etc.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.         Mad Libs Documentation                                Page 5
  266.  
  267.  
  268.         SUPPORT POLICY
  269.  
  270.         Walsh MicroSystems will provide support to SysOps that use MAD 
  271.         LIBS.  To obtain support, call the Walsh MicroSystems RBBS system 
  272.         at (215) 677-2966 and leave a comment to the SysOp.  Please 
  273.         include the version number and a complete description of the 
  274.         problem/question.  Replies will be by mail on the BBS.  Walsh 
  275.         MicroSystems is PC-Persuitable via the /PAPHI/ node.
  276.  
  277.  
  278.  
  279.  
  280.         UPDATES TO MAD LIBS
  281.  
  282.         Updates to the MAD LIBS program will be released periodically.  
  283.         Walsh MicroSystems encourages the SysOps using MAD LIBS to 
  284.         suggest improvements and changes to make it a better program for 
  285.         the users.  Feel free to leave comments to the SysOp at the 
  286.         number shown above.
  287.  
  288.  
  289.  
  290.         Revision History:
  291.         ----------------------------------------------------------------
  292.         V1.10  Original Release  11/15/1989
  293.  
  294.         V1.11  Bug Fix           12/19/1989 MSW
  295.                Fixed CHAT bug.  Door would hang in CHAT.
  296.  
  297.         V1.20  Released          12/20/1989 MSW
  298.                Increased to 250 stories (from 50)
  299.                Added Carrier Monitoring
  300.                    WatchCat or WatchDog is not needed
  301.                    but can be run.  No files are updated.
  302.  
  303.         V1.30  Internal upgrade, not released
  304.  
  305.         V1.40  Released           6/29/1990 MSW
  306.                Fixed input routines to reject cursor controls
  307.                    for backspacing (requires backspace instead)
  308.                Added save feature for SysOp to review stories
  309.                    generated by users (USERLIBS.TXT)
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.